home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / mus / misc / ahiusr.readme < prev    next >
Text File  |  2000-11-01  |  10KB  |  240 lines

  1. Short:    Retargetable audio v4.16, User's Archive
  2. Author:   Martin Blom <lcs@lysator.liu.se>
  3. Uploader: Martin Blom <lcs@lysator.liu.se>
  4. Type:     mus/misc
  5.  
  6.      This archive contains the binary distribution of AHI,
  7.      everything you need to use programs that require AHI,
  8.      and documentation in AmigaGuide® format.
  9.  
  10.      Changes since last release
  11.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  12.      Bug fixes in the device code.
  13.      Updated documentation.
  14.      New translation (hrvatski).
  15.      Added driver for Maestro Pro to the distribution.
  16.      Added driver for Concierto to the distribution.
  17.  
  18.  
  19. TITLE
  20.  
  21.      AHI Audio system
  22.  
  23. VERSION
  24.  
  25.      Release 4
  26.  
  27. AUTHOR
  28.  
  29.      Martin Blom <lcs@lysator.liu.se>
  30.  
  31. DESCRIPTION
  32.  
  33.      Retargetable Audio for AmigaOS
  34.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  35.  
  36.      (When refering to this software, the correct term is
  37.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  38.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  39.  
  40.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  41.      However, many features are lacking:
  42.  
  43.      · Very limited volime control when using 16 bit samples
  44.      · No HiFi mixing routines are available.
  45.      · No stereo samples
  46.      · No DSP effects are available.
  47.      · Less precision on some calculations
  48.      · Slower
  49.  
  50.      As you can see, this version is very primitive.  Get yourself an
  51.      accelerator!  I cannot guarantee that I will continue to support this
  52.      processor in the future.
  53.  
  54.      Quick overview
  55.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  56.  
  57.      * Driver based
  58.  
  59.      Each supported sound card is controlled by a library-based audio
  60.      driver. For a 'dumb' sound card, a new driver should be written in
  61.      a few hours. For a 'smart' sound card, it is possible to utilize an
  62.      on-board DSP, for example, to maximize performance and sound quality.
  63.      For sound cards with own DSP but little or no memory, it is possible
  64.      to use the main CPU to mix channels and do the post-processing
  65.      with the DSP. Available today are drivers for
  66.  
  67.      · Aura (sampler only)
  68.      · Clarity (sampler only)
  69.      · Concierto (Picasso IV sound module)
  70.      · Delfina DSP and Delfina Lite
  71.      · DraCo Motion
  72.      · Maestro Pro
  73.      · Melody MPEG
  74.      · Paula (8/14/14c bit)
  75.      · Prelude
  76.      · Toccata
  77.      · Wavetools
  78.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  79.  
  80.      * Fast, powerful mixing routines (yeah, right... haha)
  81.  
  82.      The device's mixing routines mix 8- or 16-bit signed samples, both
  83.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  84.      (with stereo panning if desired) data, using any number of channels
  85.      (as long as 'any' means less than 128...).  Tables can be used speed
  86.      the mixing up (especially when using 8-bit samples).  The samples can
  87.      have any length (including odd) and can have any number of loops.
  88.      
  89.      * Support for non-realtime mixing
  90.  
  91.      By providing a timing feature, it is possible to create high-
  92.      quality output even if the processing power is lacking, by saving
  93.      the output to disk, for example as an IFF AIFF or 8SXV file.
  94.      There are so-called HiFi mixing routines that can be used, which
  95.      use linear interpolation and gives 32 bit output.
  96.  
  97.      * Audio database
  98.  
  99.      Uses ID codes, much like Screenmode IDs, to select the many
  100.      parameters that can be set. The functions to access the audio
  101.      database are not too different from those in 'graphics.library'.
  102.      The device also features a requester to get an ID code from the
  103.      user.
  104.  
  105.      * Both high- and low-level protocol
  106.  
  107.      By acting both like a device and a library, AHI gives the programmer
  108.      a choice between full control and simplicity. The device API allows
  109.      several programs to use the audio hardware at the same time, and
  110.      the AUDIO: dos-device driver makes playing and recording sound very
  111.      simple for both the programmer and user.
  112.  
  113.      * Future Compatible
  114.  
  115.      When AmigaOS gets device-independent audio worth it's name, it should
  116.      not be too difficult to write a driver for AHI, allowing applications
  117.      using 'ahi.device' to automatically use the new OS interface. At
  118.      least I hope it wont.
  119.  
  120. SPECIAL REQUIREMENTS
  121.  
  122.      AmigaOS release 2.
  123.      MC68020 processor or better strongly recommended.
  124.  
  125. AVAILABILITY
  126.  
  127.      Aminet, for example:
  128.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  129.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  130.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  131.  
  132.      WWW:
  133.      http://www.lysator.liu.se/~lcs/ahi.html
  134.  
  135. PRICE
  136.  
  137.      Free. But if you use it in a shareware of commercial product,
  138.      I would like a registered copy for me and each of the audio driver
  139.      authors (this is merely a wish, you don't have to do it if you don't
  140.      think we deserve it). See the AHI User's Guide for more information.
  141.  
  142. DISTRIBUTABILITY
  143.  
  144.      Copyright ©1994-1997 Martin Blom.
  145.      Freely distributable in unmodified form.
  146.      See the AHI User's Guide for more information.
  147.  
  148.  
  149. ============================= Archive contents =============================
  150.  
  151. Original  Packed Ratio    Date     Time    Name
  152. -------- ------- ----- --------- --------  -------------
  153.      632     274 56.6% 08-Aug-97 17:39:30  AHI.info
  154.     5052    2336 53.7% 04-Nov-97 23:05:26 +ahiusr.readme
  155.      468     231 50.6% 08-Aug-97 17:39:30 +ahiusr.readme.info
  156.      628     279 55.5% 08-Aug-97 17:39:30 +BGUI.info
  157.   123588   69860 43.4% 20-Jan-97 16:35:16 +bgui.library
  158.      362     218 39.7% 21-Mar-97 21:00:00 +Install BGUI
  159.      736     367 50.1% 21-Mar-97 21:13:56 +Install BGUI.info
  160.     3700    1420 61.6% 20-Jan-97 15:20:14 +ReadMe-BETA
  161.      468     234 50.0% 21-Mar-97 20:52:20 +ReadMe-BETA.info
  162.      364     219 39.8% 21-Mar-97 20:13:22 +Copyright
  163.      468     229 51.0% 08-Aug-97 17:39:30 +Copyright.info
  164.    20821    7436 64.2% 03-Nov-97 00:13:28 +History
  165.      468     231 50.6% 08-Aug-97 17:39:30 +History.info
  166.    76850   20590 73.2% 02-Nov-97 00:01:38 +Install AHI
  167.      709     354 50.0% 08-Aug-97 17:39:30 +Install AHI.info
  168.       34      34  0.0% 03-Jul-97 12:21:16 +User's Guide
  169.      464     226 51.2% 08-Aug-97 17:39:30 +User's Guide.info
  170.     3328    2206 33.7% 04-Nov-97 22:55:14 +AddAudioModes
  171.     1686     727 56.8% 04-Nov-97 23:00:10 +ahi.cd
  172.     1720     790 54.0% 04-Nov-97 23:00:10 +ahi.ct
  173.     2858    1104 61.3% 04-Nov-97 22:54:22 +ahiprefs.cd
  174.     2783    1157 58.4% 04-Nov-97 22:54:22 +ahiprefs.ct
  175.     1114     627 43.7% 22-Jun-97 12:40:08 +ATO.readme
  176.      708     422 40.3% 04-Nov-97 23:00:36 +ahi.catalog
  177.     1572     845 46.2% 04-Nov-97 22:54:54 +ahiprefs.catalog
  178.      726     432 40.4% 04-Nov-97 23:00:30 +ahi.catalog
  179.     1682     909 45.9% 04-Nov-97 22:54:46 +ahiprefs.catalog
  180.      778     449 42.2% 04-Nov-97 23:00:34 +ahi.catalog
  181.     1756     940 46.4% 04-Nov-97 22:54:58 +ahiprefs.catalog
  182.      750     463 38.2% 04-Nov-97 23:00:30 +ahi.catalog
  183.     1456     816 43.9% 04-Nov-97 22:54:50 +ahiprefs.catalog
  184.      730     443 39.3% 04-Nov-97 23:00:26 +ahi.catalog
  185.     1570     865 44.9% 04-Nov-97 22:54:44 +ahiprefs.catalog
  186.      740     445 39.8% 04-Nov-97 23:00:28 +ahi.catalog
  187.     1678     912 45.6% 04-Nov-97 22:55:00 +ahiprefs.catalog
  188.      686     422 38.4% 04-Nov-97 23:00:28 +ahi.catalog
  189.     1464     757 48.2% 04-Nov-97 22:54:48 +ahiprefs.catalog
  190.      706     417 40.9% 04-Nov-97 23:00:28 +ahi.catalog
  191.     1556     839 46.0% 04-Nov-97 22:54:54 +ahiprefs.catalog
  192.      776     463 40.3% 04-Nov-97 23:00:26 +ahi.catalog
  193.     1742     963 44.7% 04-Nov-97 22:54:46 +ahiprefs.catalog
  194.      804     492 38.8% 04-Nov-97 23:00:32 +ahi.catalog
  195.     1780     969 45.5% 04-Nov-97 22:55:02 +ahiprefs.catalog
  196.      734     459 37.4% 04-Nov-97 23:00:24 +ahi.catalog
  197.     1560     864 44.6% 04-Nov-97 22:54:52 +ahiprefs.catalog
  198.      812     481 40.7% 04-Nov-97 23:00:32 +ahi.catalog
  199.     1764     964 45.3% 04-Nov-97 22:54:50 +ahiprefs.catalog
  200.      732     430 41.2% 04-Nov-97 23:00:26 +ahi.catalog
  201.     1490     822 44.8% 04-Nov-97 22:54:56 +ahiprefs.catalog
  202.      888     484 45.4% 04-Jun-97 19:56:46 +Translation.ReadMe
  203.      732     455 37.8% 04-Nov-97 23:00:34 +ahi.catalog
  204.     1582     911 42.4% 04-Nov-97 22:55:00 +ahiprefs.catalog
  205.    44912   21362 52.4% 04-Nov-97 22:59:30 +ahi.device
  206.    40440   20258 49.9% 04-Nov-97 22:56:40 +ahi.device.000
  207.    44856   21311 52.4% 04-Nov-97 22:58:06 +ahi.device.060
  208.     3660    2249 38.5% 10-Oct-97 19:15:26 +concierto.audio
  209.     4808    2710 43.6% 21-Jul-97 21:02:12 +delfina.audio
  210.     6376    3598 43.5% 04-Nov-97 22:46:26 +filesave.audio
  211.     6440    3634 43.5% 04-Nov-97 22:47:10 +filesave.audio.000
  212.     3460    1831 47.0% 25-Sep-97 21:07:42 +maestropro.audio
  213.     2040    1264 38.0% 13-Aug-97 19:43:56 +melody.audio
  214.     9384    4458 52.4% 04-Nov-97 22:47:30 +paula.audio
  215.     9488    4475 52.8% 04-Nov-97 22:47:42 +paula.audio.000
  216.     9360    4401 52.9% 13-May-97 11:02:16 +prelude.audio
  217.     6736    3371 49.9% 04-Nov-97 22:48:18 +toccata.audio
  218.     6780    3396 49.9% 04-Nov-97 22:48:50 +toccata.audio.000
  219.     3652    2065 43.4% 04-Nov-97 22:49:00 +wavetools.audio
  220.      428     144 66.3% 05-Jun-97 16:09:58 +CONCIERTO
  221.      868     205 76.3% 21-Jul-97 21:02:12 +DELFINA
  222.      580     176 69.6% 04-Nov-97 22:47:12 +FILESAVE
  223.      456     147 67.7% 25-Sep-97 18:34:46 +MAESTROPRO
  224.      580     172 70.3% 12-Jun-97 19:07:24 +MELODY
  225.     2020     324 83.9% 04-Nov-97 22:47:44 +PAULA
  226.      444     150 66.2% 13-May-97 11:02:16 +PRELUDE
  227.      876     197 77.5% 04-Nov-97 22:48:52 +TOCCATA
  228.      600     171 71.5% 04-Nov-97 22:49:02 +WAVETOOLS
  229.      160     121 24.3% 27-Mar-97 12:08:50 +AUDIO
  230.      466     251 46.1% 29-Jan-97 15:56:22 +AUDIO.info
  231.     1522     876 42.4% 03-Jun-97 12:19:56 +AUDIO.MWB.info
  232.    47276   15838 66.4% 04-Nov-97 23:14:10 +ahi.guide
  233.     5568    3386 39.1% 04-Nov-97 22:49:22 +AHI-Handler
  234.      617     386 37.4% 04-Nov-97 22:55:02 +AHI.info
  235.     1849    1351 26.9% 04-Nov-97 22:55:04 +AHI.MWB.info
  236.    33044   17476 47.1% 04-Nov-97 22:53:42 +AHI_BGUI
  237.    32496   17449 46.3% 04-Nov-97 22:54:18 +AHI_MUI
  238. -------- ------- ----- --------- --------
  239.   615497  289485 52.9% 11-Nov-97 21:23:48   85 files
  240.